3D Graphics Programming with QuickDraw 3D 1.5.4

Picking With Window Rectangles

QuickDraw 3D provides routines that you can use to pick with window rectangles. The dimensions of the rectangle are in the resolution of the current draw context.

Q3WindowRectPick_New

You can use the Q3WindowRectPick_New function to create a new window-rectangle pick object.



 
TQ3PickObject Q3WindowRectPick_New (

                     const TQ3WindowRectPickData *data);

data: A pointer to a window-rectangle pick data structure.

DESCRIPTION

The Q3WindowRectPick_New function returns, as its function result, a new window-rectangle pick object having the characteristics specified by the data parameter. If Q3WindowRectPick_New fails, it returns NULL .

Q3WindowRectPick_GetRect

You can use the Q3WindowRectPick_GetRect function to get the rectangle of a window-rectangle pick object.



 
TQ3Status Q3WindowRectPick_GetRect (

                     TQ3PickObject pick, 

                     TQ3Area *rect);

pick: A window-rectangle pick object.
rect: On exit, the current rectangle of the specified window-rectangle pick object.

DESCRIPTION

The Q3WindowRectPick_GetRect function returns, in the rect parameter, the current rectangle of the window-rectangle pick object specified by the pick parameter.

Q3WindowRectPick_SetRect

You can use the Q3WindowRectPick_SetRect function to set the rectangle of a window-rectangle pick object.



 
TQ3Status Q3WindowRectPick_SetRect (

                     TQ3PickObject pick, 

                     const TQ3Area *rect);

pick: A window-rectangle pick object.
rect: The desired rectangle for the window-rectangle pick object.

DESCRIPTION

The Q3WindowRectPick_SetRect function sets the rectangle of the window-rectangle pick object specified by the pick parameter to the rectangle specified by the rect parameter.

Q3WindowRectPick_GetData

You can use the Q3WindowRectPick_GetData function to get the data associated with a window-rectangle pick object.



 
TQ3Status Q3WindowRectPick_GetData (

                     TQ3PickObject pick, 

                     TQ3WindowRectPickData *data);

pick: A window-rectangle pick object.
data: On exit, a pointer to a window-rectangle pick data structure.

DESCRIPTION

The Q3WindowRectPick_GetData function returns, through the data parameter, information about the window-rectangle pick object specified by the pick parameter. See "Window-Rectangle Pick Data Structure" for the structure of a window-rectangle pick data structure.

Q3WindowRectPick_SetData

You can use the Q3WindowRectPick_SetData function to set the data associated with a window-rectangle pick object.



 
TQ3Status Q3WindowRectPick_SetData (

                     TQ3PickObject pick, 

                     const TQ3WindowRectPickData *data);

pick: A window-rectangle pick object.
data: A pointer to a window-rectangle pick data structure.

DESCRIPTION

The Q3WindowRectPick_SetData function sets the data associated with the window-rectangle pick object specified by the pick parameter to the data specified by the data parameter.